2) Frontend Web Documentation
2.1 نظرة عامة
واجهة المستخدم على الويب ستكون مخصصة للزوار والعملاء، وتوفر نفس وظائف التطبيق تقريبًا:

تصفح المتاجر

تصفح الكوبونات

تصفح عروض الكاش باك

البحث

المفضلة

الحساب

الصفحات الثابتة

2.2 التقنية المقترحة
Next.js

TypeScript

Tailwind CSS أو MUI

Axios

React Query أو Zustand

i18n

Responsive Design

2.3 الصفحات الرئيسية
الصفحة الرئيسية Home
المحتويات:

Header

Search

Banner Slider

Categories

Featured Stores

Latest Coupons

Cashback Section

Footer

صفحة المتاجر Stores Listing
قائمة المتاجر

فلترة حسب التصنيف

بحث

ترتيب

صفحة تفاصيل المتجر Store Details
اسم المتجر

اللوجو

وصف

زر تسوق الآن

قائمة الكوبونات

عروض الكاش باك

صفحة الكوبونات Coupons Listing
بطاقات كوبونات

البحث

الفلترة

النسخ

صفحة تفاصيل الكوبون Coupon Details
اسم المتجر

الكود

الوصف

الخصم

الشروط

زر نسخ / تسوق الآن

صفحة Cashback
قائمة المتاجر

النسبة

زر التفعيل

صفحة المفضلة Favorites
Stores / Coupons المحفوظة

صفحة الحساب Profile
بيانات المستخدم

اللغة

الدولة

الكاش باك

الإشعارات

صفحات ثابتة
FAQ

Terms

Privacy

Contact Us

2.4 Components الرئيسية
Navbar

Footer

BannerSlider

CategoryCard

StoreCard

CouponCard

CashbackCard

FilterBar

SearchBox

FavoriteButton

Pagination

EmptyState

Loader

2.5 تدفق المستخدم
يفتح الموقع

يشاهد الصفحة الرئيسية

يختار متجر أو كوبون

ينسخ الكوبون أو يضغط تسوق الآن

يسجل دخول لحفظ المفضلة أو متابعة الكاش باك

2.6 إدارة الحالة
مقترح:

authStore

settingsStore

favoritesStore

filtersStore

2.7 التكامل مع الـ API
أمثلة:

GET /home

GET /stores

GET /stores/{id}

GET /coupons

POST /favorites/toggle

POST /auth/login

2.8 متطلبات الـ UI/UX
Arabic RTL + English LTR

Responsive لكل الشاشات

أزرار واضحة لنسخ الكوبون

إبراز المتاجر المميزة

سرعة تحميل عالية

SEO جيد للمتاجر والكوبونات

2.9 الصفحات التي تحتاج حماية
favorites

profile

cashback history

notifications

2.10 المجلدات المقترحة
web-app/
 ├─ app/
 ├─ components/
 ├─ services/
 ├─ hooks/
 ├─ store/
 ├─ types/
 ├─ utils/
 └─ public/
2.11 الـ Services
auth.service.ts

home.service.ts

stores.service.ts

coupons.service.ts

cashback.service.ts

favorite.service.ts

settings.service.ts

2.12 الأولويات
Layout عام

Home

Stores

Store Details

Coupons

Auth

Favorites

Profile

Static Pages

3) React Native Mobile Documentation
3.1 نظرة عامة
تطبيق الموبايل يقدم نفس خدمات الويب لكن بتجربة مخصصة للجوال:

تصفح سريع

نسخ الكوبونات

إشعارات فورية

مفضلة

حساب المستخدم

كاش باك

3.2 التقنية المقترحة
React Native

Expo أو CLI

TypeScript

React Navigation

Axios

Zustand أو Redux Toolkit

AsyncStorage

Firebase Push Notifications

3.3 الهيكل العام للشاشات
Splash Screen
شعار التطبيق

تحميل الإعدادات الأولية

Onboarding
مقدمة للتطبيق

شرح الخصومات والكاش باك

Auth
Login

Register

Forgot Password

Main Tabs
Home

Discover

Cashback

Account

3.4 الشاشات الرئيسية
Home Screen
Search

Banners

Featured Stores

Featured Coupons

Categories

Cashback Stores

Discover Screen
كل العروض

فلترة

ترتيب

View Grid / List

Store Details Screen
لوجو المتجر

وصف

زر مشاركة

زر مفضلة

زر تسوق الآن

قائمة الكوبونات

Coupon Details Screen
تفاصيل العرض

الكود

الخصم

الشروط

نسخ الكوبون

Cashback Screen
قائمة متاجر الكاش باك

النسبة

الشروط

زر التفعيل

Favorites Screen
المتاجر والكوبونات المحفوظة

Account Screen
الحساب

اللغة

الدولة

الإعدادات

FAQ

سياسة الخصوصية

تسجيل الخروج

Notifications Screen
قائمة الإشعارات

فتح التفاصيل

3.5 Navigation
Stack Navigator

Bottom Tab Navigator

Auth Stack

Main Stack

3.6 Components المشتركة
AppHeader

SearchInput

BannerCarousel

StoreCard

CouponCard

CashbackCard

PrimaryButton

EmptyState

LoadingIndicator

FilterModal

3.7 إدارة الحالة
auth store

app settings store

home data store

favorites store

notifications store

3.8 التخزين المحلي
access_token

user profile

selected language

selected country

onboarding status

3.9 الـ API Integration
login/register

home data

stores list

coupons list

coupon copy

cashback activation

favorites

profile update

notifications

3.10 Push Notifications
الحالات:

كوبون جديد

متجر جديد

عروض خاصة

تحديثات الكاش باك

رسائل تسويقية

3.11 المتطلبات الوظيفية
دعم RTL

نسخ الكود بسهولة

مشاركة العرض

فتح الروابط الخارجية

حفظ المفضلة

استلام إشعارات

أداء سريع

3.12 المجلدات المقترحة
mobile-app/
 ├─ src/
 │  ├─ screens/
 │  ├─ components/
 │  ├─ navigation/
 │  ├─ services/
 │  ├─ store/
 │  ├─ hooks/
 │  ├─ utils/
 │  ├─ types/
 │  └─ assets/
3.13 ترتيب التطوير
Splash + Auth

Main Tabs

Home

Store Details

Coupon Details

Favorites

Cashback

Account

Notifications

